Changelog


==========================================
Graphical Installer for NSIS - Changelog
==========================================

This document describes history of Graphical Installer development and changes among released versions.

This document is related only to Graphical Installer for NSIS (Nullsoft Scriptable Install System).

Latest version:

------------------------------------
General Release, Build: 2023.1
------------------------------------

Released on 30th July 2023

Support for latest NSIS 3 release: 3.09
This release is focused on new feature "Custom Dimensions" and improved user experience
Added new example Custom Dimensions Custom Dimensions to show how to create setup with custom Inner Dialog position
Updated several examples with refreshed bacgrounds
New symbol GRAPHICAL_INSTALLER_CUSTOM_UI for setting the Custom UI. Use Resource Hacker (free tool) to modify the UI file.
See GRAPHICAL_INSTALLER_CUSTOM_UI symbol documentation for more info

Graphical Installer Wizard, Build: 2023.1:
- Improved script generating in newest NSIS versions
- BitmapCutter.exe supports new parameters: -o -x


------------------------------------
General Release, Build: 2022.2
------------------------------------

Released on 16th September 2022

Official support forWindows 11 (also ARM)
Official support for electron-builder scripts (editing any electron-builder .nsi or .nsh scripts)
Installer now supports multiple processor architectures (x86, x64, arm64, ia64) - useful when running Windows on ARM

Graphical Installer Wizard v1.18.01:
-Warning message 'You need an Administrator rights to write into specific folders' is shown correctly
-Plugin is correctly registered in HM NIS Edit (previously the menu item was missing)
-Fixed displaying plugin name in HM NIS Edit (previously only 'G' was shown)
-Fixed issues with Unicode/ANSI build
-Fixed issues with opening script(s) in Explorer/Notepad/Default editor


------------------------------------
General Release, Build: 2022.1
------------------------------------

Released on 14th January 2022

- This release contains the largest changes in probably last few years
- Changes are applied automatically after recompiling the script with this new Build. There is no need to upgrade the scripts or do any manual changes.
- We added an options to set everything to the previous behaviour.
- Changed naming convention: instead of "Version" the term "Build" is used (YYYY is Year of release and .N is Build sequence number)
- Graphical Installer for NSIS is now completely independent on NSIS version (works with any NSIS 2 or NSIS 3)

- Installers now distinguish between "focused" and "mouse over" control states (both can be active at the same time)
- In earlier versions of Graphical Installer the "focused" state was applied when user pressed the Tab key to select some control (then the control could be activated using Enter key or Space).
- Now the state is applied when mouse is moved over the Button controls and we added new feature to signalize "focused" state of control
- Old "focused" behaviour can be still activated disabling the ${GraphicalInstallerEnableButtonsHighlight} macro
- Changed default behaviour: Button controls now react to mouse over (previously on focus)
- New macro that enables/disables drawing of focus rectangles (applies to Button, CheckBox, RadioButton controls).
- See ${GraphicalInstallerDrawFocusRects} macro documentation for more info
- Changed default behaviour: Moving installer window with mouse is now enabled by default.
- See ${GraphicalInstallerEnableDragging} macro documentation for more info.
- Setup of Graphical Installer for NSIS itself uses new features (moving mouse over buttons, enabled dragging) and has new refreshed look.

Graphical Installer Wizard v1.17.01:
- Improved script generating in newest NSIS versions
- Whole manual is more user friendly - new tips, troubleshooting sections and more
- Reworked examples with support of latest NSIS features
- Added more details to offline and online documentation
- Wizard is now faster and more straightforward (requires less steps/clicks)
- Correct converting the .nsi script with Unicode true defined (Error: Can't change target architecture after data already got compressed or header already changed! + Error: Unable to set target charset (adequate stub not found?)
- App Updater: correct handling of cached files when checking for new version, showing user friendly error message(s)
- Drag & Drop the files into Wizard boxes may cause AV Exceptions in some rare cases. Sorry for these inconveniences :(

--------------------
v4.11.01 (Xolka)
--------------------

Released on 28th July 2021
Updated on 10th October 2021

Major changes:

- Support for latest NSIS 3 release, 3.07 and 3.08
- BitmapCutterGUI has been completely refreshed - new design and features
- BitmapCutterGUI now allows pasting image directly from Clipboard (Ctrl + V):
- It supports image data (like picture from MS Paint, Gimp, Photoshop or similar editor) and Base64 data (e.g. from www.base64-image.de)
- BitmapCutterGUI now allows to save the resulting file to disk (if image data was pasted from Clipboard)

Graphical Installer Wizard v1.16.01:
Improved script generating in newest NSIS versions

- How to create background image for NSIS (Inno Setup)? articles from online Tutorial were added to offline Manual
- Added more details into BitmapCutterGUI section in offline Manual

--------------------
v4.10.01 (Webka)
--------------------

Released on 7th August 2020

Major changes:

- Support for latest NSIS releases: 3.06 and 3.06.1
- Security fixes and improvements

Graphical Installer Wizard v1.15.01:
Added possibility to cancel the Open file dialog when converting the existing .nsi file
Security fixes and improvements
Support for recently released RAD & Installer - 10.4 Sydney
(Binary compatible with previous version)
Support for new Eclipse versions (up to 4.16)

- United, simplified & updated changelog, manual, website

--------------------
v4.9.01 (Vilka)
--------------------

Released on 5th January 2020

Major changes:

- Support for latest NSIS 3 release, 3.05. Important note: ANSI targets are deprecated, consider moving to Unicode!
- Setup Dialogs (Installer and Uninstaller Pages) generated with Install Designer (NEW!) work out of the box with Graphical Installer
- New Example: Install Designer
- All examples now use 'RequestExecutionLevel user' and 'InstallDir "$LOCALAPPDATA\..."'

Graphical Installer Wizard v1.14.01:
Typing color manually into box (any GIW color - buttons, texts, ...) now immediately colorizes the associated shape with entered color
United naming and versions - BitmapCutter version now matches the GIW version
Note: version 1.13.01 was skipped as 13 is considered an unlucky number in Slovakia
Generating scripts with 'RequestExecutionLevel user'
More strict Trial restrictions (GIW closes if Trial is expired)
Fixes and optimizations in GIW script generator
Fixed bug: not showing HTML help after pressing F1 key
Configuration: Drag & Dropping the makensis.exe detects Graphical Installer and sets correct paths automatically
Configuration: Open dialog now browses into NSIS installation folder automatically
Added warning 'You need an Administrator right to write into specific folders (e.g. C:\Program Files (x86)\).'

Support for new Eclipse versions (up to 4.14)
Updated tools (BitmapCutter + GUI - Version V, 1.14.01)
Various improvements and fixes

Minor changes and fixes:

- Updated manual
- Fixed wrong links
-

--------------------
v4.8.01 (Ulinka)
--------------------

Released on 7th January 2019

Major changes:

- Support for latest NSIS 3 release (3.04)
- New feature: Moving installer (frameless) window with mouse (click anywhere and move the window)
- New feature: Drag & Drop installation page with advanced security
Prevents bots from installing the software (human interaction is required to continue the installation, similar to macOS .dmg installer)
- 10 new buttons (Modern style)
- Examples can be opened directly from Help (clickable links)
- Added French language

Graphical Installer Wizard v1.12.01:
Updated texts
Support for new Eclipse versions (up to 4.10)

- Updated tools (BitmapCutter + GUI, v1.12.01)
- Various improvements and fixes

Minor changes and fixes:

- Updated manual (new section for Drag & Drop)
- Fixed wrong links
-
--------------------
v4.7.01 (Tinka)
--------------------

Released on 2nd February 2018

Major changes:

- Support for latest NSIS 3 release (3.03)
- Supported new NSD_ controls/functions
- New tool: SetupProjects Converter

Graphical Installer Wizard v1.11.01:
Fixed bugs when generating new scripts
Support for new Eclipse versions (up to 4.8, Photon)

- Updated tools (BitmapCutter + GUI, v1.11.01)
- Various improvements and fixes

Minor changes and fixes:

- Updated manual (section SetupProjects Converter)
- Fixed wrong links


--------------------
v4.6.01 (Sonka)
--------------------

Released on 11th August 2017

Major changes:

- Support for latest NSIS 3 release (3.02 and 3.02.1)
- Changed all NSIS icons to NSIS 3 style everywhere - also on the website and in the manual.
- MessageBox Designer now shows new line characters ($\r $\n %n #13#10) correctly in Preview dialog
- Improved behaviour in enviroments with various high DPI settings
- New symbol: VISUAL_UI_NOFRAME which hides window frame (Visual_UI feature - see example)

Graphical Installer Wizard v1.10.01:
Fixed bugs
Supported latest Eclipse versions {4.7 (Oxygen)}
Full support for 4 IDEs (Visual Studio/Visual & Installer, RAD Studio/RAD & Installer, HN NIS Edit, Eclipse) + Standalone application

- Updated tools (BitmapCutter + GUI)
- Various improvements and fixes

Minor changes and fixes:

- Reworked manual (License, EULA)
- Updated copyright year


--------------------
v4.5.01 (Rozka)
--------------------

Released on 2nd January 2017

Major changes:

- Support for latest NSIS 3 release (3.01)
- New tool MessageBox Designer - an application for fast and easy creating of MessageBox instructions (script generator)

Graphical Installer Wizard v1.9.01:
Fixed bugs
Supported all latest Eclipse versions {4.3 (Kepler), 4.4 (Luna), 4.5 (Mars), 4.6 (Neon)}
Full support for 4 IDEs (Visual Studio/Visual & installer, RAD Studio/RAD & Installer, HN NIS Edit, Eclipse) and standalone application

- Updated tools (BitmapCutter + GUI)
- Various improvements and fixes

Minor changes and fixes:

- Reworked manual


--------------------
v4.4.01 (Patka)
--------------------

Released on 5th August 2016

Major changes:

*** Long-awaited version 3 of NSIS is finally ready.
- It comes with optional Unicode support, still works on all the same versions of Windows,
- supports Windows 10, and adds a lot of other small features and fixes. ***

- Support for latest NSIS 3 releases (3.0 and 3.0 Release Candidate 2)
- New symbols (see manual for details):
GRAPHICAL_INSTALLER_HIDE_CANCEL_BUTTON: Hides Cancel button on all installer's pages
GRAPHICAL_INSTALLER_HIDE_BACK_BUTTON: Hides Back button on all installer's pages

- Fixed bug: redrawing Inner Dialog area for nsDialogs pages and Start Menu page
- Fixed issues with ${NSD_FreeImage} calls
- Fixed bug: redrawing uninstaller pages (Visual_UI feature)
- Fixed issues with switching installer from skinned to classic look (symbol GRAPHICAL_INSTALLER_PROJECT_UID)

Graphical Installer Wizard v1.8.01:
Improved script generation (with new symbols)
Checking for new version

- Updated tools (BitmapCutter + GUI)
- Various improvements and fixes
- Improved German (Deutsch) texts in installer

Minor changes and fixes:

- Updated manual
- Updated ButtonEvent plug-in (v0.8)
- Updated nsDialogs_setImageOle.nsh (v1.2)


--------------------
v4.3.01 (Oxanka)
--------------------

Released on 12th April 2016

Major changes:

- Support for latest NSIS 3 release (3.0 Release Candidate 1)
- Support for latest NSIS 2 release (2.51)
- New feature: Visual_UI - creating installers with Visual Studio Setup like design
- New symbols (see manual for details):
GRAPHICAL_INSTALLER_PROGRESSBAR_COLOR: Progressbar color (Install page)
GRAPHICAL_INSTALLER_PROGRESSBAR_BACKCOLOR: Progressbar background color (Install page)
GRAPHICAL_INSTALLER_COMPONENTS_BACKCOLOR: Components page TreeView background color
GRAPHICAL_INSTALLER_ACCEPT_LICENSE_BOLD: Bold Accept License checkbox (or radiobutton) in License page

- New symbols (Visual_UI feature):
GRAPHICAL_INSTALLER_VISUAL_UI: Switch to Visual_UI mode
GRAPHICAL_INSTALLER_LOGO: Visual_UI Logo
GRAPHICAL_INSTALLER_BACKGROUND_COLOR: Background color
GRAPHICAL_INSTALLER_BACKGROUND_COLOR_DARKER: Background color (Darker area around buttons)
GRAPHICAL_INSTALLER_ACCENT_COLOR: Accent color (buttons, elements highlights)

Graphical Installer Wizard v1.7.01:
Improved script generation (with new symbols)
Standalone application (Wizard.exe)

- New example(s): Visual_UI (black + white)
- Updated tools (BitmapCutter + GUI)
- All unSigned's installers are now dual signed with SHA-1 and SHA-256 certificates
- Improved installer (As recommended by Microsoft's desktop applications guideline):
https://msdn.microsoft.com/en-us/library/windows/desktop/dn742461.aspx:
No welcome, page, Print and Save license buttons, ...
- Various improvements and fixes

Minor changes and fixes:

- Updated manual (Help system):
Better description for .graphics.nsh section
Added Visual_UI section
More context sensitive
Help for BitmapCutter tools

- United color format (0xRRGGBB is by default used everywhere)
- Colors also accept RRGGBB format (without 0x prefix)
- Updated nsDialogs_setImageOle.nsh to version 1.2


--------------------
v4.2.01 (Norka)
--------------------

Released on 1st January 2016

Major changes:

- Support for latest NSIS 3 release (3.0 Beta 3)
- Support for latest NSIS 2 releases (2.47, 2.48, 2.49 and 2.50)
- Many security issues were improved
- Possible to switch between skinned and classic design by changing single line of script (GRAPHICAL_INSTALLER_PROJECT_UID)
- Merged changes from NSIS releases into code
- Next button is automatically highlighted
- New function ScaleMaskImage (GraphicalInstaller.dll) for mask resizing (Auto DPI)
- New user-friendly symbols and macros:
${GraphicalInstallerChangeUI}
${GraphicalInstallerRedrawCheckBox}
${GraphicalInstallerRedrawRadioButton}
${GraphicalInstallerRedrawLabel}
${GraphicalInstallerInitInstallPage}
${GraphicalInstallerRedrawnsDialogsPage}
${GraphicalInstallerRedrawInstallOptionsPage}

- Supported InstallOptions (however it is officially deprecated)
Graphical Installer Wizard v1.6.01:
- Improved script generation (with new symbols)

- New examples (InstallOptions, Auto DPI)
- Updated tools (BitmapCutter + GUI)
- Various improvements and fixes

Minor changes and fixes:

- Updated manual (fixed links and mistakes)
- Fixed small typos


--------------------
v4.1.01 (Majka)
--------------------

Released on 19th August 2015

Major changes:

- Support for latest NSIS 3 releases (3.0 Beta 2, Beta 1, Beta 0, 3.0 Alpha 2, Alpha 1, Alpha 0)
- Windows 10 support
- New directives and options

Graphical Installer Wizard v1.5.01:
- Support for RAD & Installer (RAD Studio integration)
- Background picture can be in .gif format
- Improved loading .jpg and .bmp pictures
- Added preview in Open picture dialog (preview is shown for all extensions)
- Removed annoying 'Could not get Background/Button picture dimensions...' message (if picture format was correct)
- Fixed rare EInvalidGraphic exception(s)

- New example (RAD & Installer - RAD Studio)
- Updated tools (BitmapCutter + GUI)
- Various improvements and fixes

Minor changes and fixes:

- Updated manual (fixed links and mistakes)
- Fixed small typos


--------------------
v4.01 (Lucka)
--------------------

Released on 12th June 2014

Major changes:

Full support for NSIS 3 (alpha versions + beta versions; Ansi + Unicode; x86 + x64)
- Seamless script integration (no need to register the GRAPHICAL_INSTALLER_PROJECT_UID)
- Removed GraphicalInstaller_projects.nsh file
- Removed ProjectManager.exe
- Removed GraphicalInstaller_translation.nsh
- Whole process is now much simpler and faster (less case sensitive, files are checked for existence, ...)
- Drag and Drop tools
- Bigger buttons (83x26 pixels) with 4 states: normal, focused, pressed, disabled (2 new states!)
- Transparent splash picture (irregular form)
- 10 new buttons pictures

- Graphical Installer Wizard v1.4.01:
- Better handling old script during conversion to Graphical Installer project
- New options: Texts colors for focused and disabled buttons
- Supported Start menu creating
- Splash picture can be transparent (irregular form)

- New functions in GraphicalInstaller.dll (v1.4.01)
- Creating irregular buttons (buttons with alpha mask)

- New examples (Start menu)

Minor changes and fixes:

- Updated manual (fixed links and mistakes)
- Fixed small typos


======================================
Previous versions [Third generation]
======================================

--------------------
v3.3.01 (Kvetka)
--------------------

Released on 21st August 2013

Major changes:

Full support for NSIS 3 (3.0a1: Ansi + Unicode, x86 + x64)
Graphical Installer Wizard v1.3.01:
- United texts, versions and namings
- Better integration with Visual & Installer, HM NIS Edit, Eclipse

- New functions in GraphicalInstaller.dll (v1.1.01)
- Creating windows with transparency
- Creating windows without borders

- New example (Irregular Form)
- Link control (Hyperlink) supports transparent color

Minor changes and fixes:

- Updated manual (fixed links and mistakes)
- Improved installer


--------------------
v3.2.01 (Julka)
--------------------

Released on 30th May 2013

Major changes:

- Full support for NSIS 3 (3.0a0 - Ansi + Unicode, x86)
- NSIS 2 (up to version 2.46-5) is also supported
Graphical Installer Wizard v1.2.01:
- support for Themes
- fixed Alt key press bug (Windows XP, Vista, 7, 8)
- context sensitive help

- New application BitmapCutterGUI.exe (v1.0.0.1):
- Windows application for creating background images

- BitmapCutter.exe version D (1.1.01):
- colored output
- new option '-g' for BitmapCutterGUI.exe

- Graphical Installer Wizard for Eclipse (v1.2.01)

Minor changes and fixes:

- Updated manual


--------------------
v3.1.01 (Ivanka)
--------------------

Released on 17th October 2012

Major changes:

- Support for multiple DPI settings
- New feature in Graphical Installer Wizard - possibility to convert existing script
- Improved Project Manager
- Better integration between Visual & Installer and Graphical Installer
- Updated manual (support for Visual & Installer)
- New examples

Minor changes and fixes:

- Fixed random crash in HM NIS Edit (caused by plug-in)
- Graphical Installer Wizard optimizations
- Small bugs fixes


--------------------
v3.01 (Hanka)
--------------------

Released on 10th January 2012

Major changes:

- SkinnedControls plug-in is no longer used
- GraphicalInstaller plug-in introduced (v1.01) - replacement of SkinnedControls plug-in with many new features
- Added possibility to subclass labels using GraphicalInstaller plug-in
- Added possibility to subclass RadioButtons and CheckBoxes using GraphicalInstaller plug-in
- Added BitmapCutter.exe version C [version naming was changed]
- BitmapCutter.exe now fully supports both Graphical Installer for NSIS and Graphical Installer for Inno Setup
- Added full support for XPStyle [on] for CheckBox and RadioButton controls

Minor changes and fixes:

- Updated examples
- Updated manual
- Updated Graphical Installer Wizard plug-in for HM NIS Edit [hmne_graphicalinstaller.dll] into version C
[version naming was changed, several bugs were fixed, added new menu items with new functionality]
- Improved installer options


=======================================
Previous versions [Second generation]
=======================================

--------------------
v2.4.01 (Gitka)
--------------------

Released on 22nd July 2011

Major changes:

- New tool: ProjectManager (located in NSIS/Graphical Installer directory)
- Improved support for custom picture on every installer's page
- New example (Multiple Backgrounds)
- Removed slow loading of inner dialog image for RTL languages

Minor changes and fixes:

- Optimized loading of skin pictures
- Added Bugs.txt file
- Corrected manual


--------------------
v2.3.01 (Francka)
--------------------

Released on 12th April 2011

Major changes:

- Added macro GRAPHICAL_INSTALLER_NSDIALOGS_PAGE_REDRAW for nsDialogs
- Cleaned code, massive optimalizations
- Splash Bitmap has moved to main .nsi file
- Added localization (GraphicalInstaller_translation.nsh file)
- Possibility to Print and Save license file
- Fixed button colour bug in Graphical Installer Wizard plug-in for HM NIS Edit (v1.1.01)
- Created .chm documentation with examples
- Fixed wrong Buttons colour for uninstaller
- New nsDialogs example

Minor changes and fixes:

- Fixed bug in SkinnedControls.dll (buttons were drawn incorrectly after MessageBox)
- Added macro GRAPHICAL_INSTALLER_INST_PAGE_INIT
- Function .onGUIEnd and un.onGUIEnd moved to main .nsi file


-----------------
v2.2.01 (Evka)
-----------------

Released on 7th February 2011

Major changes:

- Fixed "Finish page" bug (incorrect colour of texts)
- Added support for Unicode version of NSIS (http://www.scratchpaper.com/)
- Added possibility to mix LTR/RTL languages in one installer
- New version of BitmapCutter (v2.2.01 - suporting RTL images)
- Used Unicode version of SkinnedControls plug-in
- Stable version of plug-in for HM NIS Edit with Graphical Installer Wizard (v1.01)

Minor changes and fixes:

- Added new example for RTL languages
- Fixed incorrect version labels


------------------
v2.1.01 (Danka)
------------------

Released on 23th November 2010

Major changes:

- Support for OLE images at background (.jpg .gif .bmp)
- Function .onInit has moved away from GraphicalInstaller_functions.nsh file
- New skins
- New version of BitmapCutter (v2.1.01 suporting .jpg .gif .bmp)

Minor changes and fixes:

- Fixed MUI_LANGDLL_DISPLAY issue


----------------
v2.01 (Cilka)
----------------

Released on 4th November 2010

Initial release of Graphical Installer v2.

Major changes:

- Added plug-in for HM NIS Edit with Wizard for creating new installers (beta)
- Each project has own .graphics.nsh file
- All projects use the same file GraphicalInstaller_functions.nsh
- Every project must have it's Unique ID registered in GraphicalInstaller_projects.nsh
- Custome pages are no longer implemented usign InstallOptions
- nsDialogs plug-in is used for Welcome and Finish pages
- New version of BitmapCutter (v2.01)

Minor changes and fixes:

- Fixed several visual bugs
- Removed flickering


======================================
Previous versions [First generation]
======================================

------------------
v1.1.01 (Betka)
------------------

Released on 19th June 2010

Major changes:

- Removed dependency on plug-in SkinnedButton
- Using of MUI2 instead of MUI

Minor changes and fixes:

- Fixed several visual bugs
- Added text for 'Select directory' label


---------------
v1.01 (Anka)
---------------

Released on 1st March 2010

Initial release of Graphical Installer.
This is very first public version available.